home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 3 / Amiga Tools 3.iso / terminal / xprz / readme < prev    next >
Encoding:
Text File  |  1994-11-20  |  4.6 KB  |  106 lines
  1.  
  2.     MAGIC NAME: XPRZ3
  3.     xprzmodem.library v3.3 & xprzedzap.library v3.3
  4.  
  5.     xprZ33.lha   contains  AmigaGuide  and  plain  text  docs  as  well  as
  6. 68000/10/20/30/40 versions of both xprzmodem.library and xprzedzap.library.
  7. These  libraries  all require WB2 or better and support language catalogues
  8. via  locale.library.   This  release  merges  the  source levels of the two
  9. libraries so that both can take advantage of all fixes and enhancements.
  10.  
  11.    XPRzedzap.library is an enhanced version of xprzmodem.library for use in
  12. Mailers as well as BBSs and Terminal programs supporting XPR protocols.  It
  13. provides multiple zmodem-derived protocols, including:
  14.     Zmodem, SZmodem, ZedZip, ZedZap and DirectZap.  
  15.   It  is  a complete replacement for xprzmodem.library, xprszmodem.library,
  16. xprdzap.library and all previous versions of xprzedzap.library.
  17.  
  18.     XPRzmodem.library  is  also  enhanced  to provide the same protocols as
  19. xprzedzap.library,  well  as  support  for SZmodem.  It is about 1K smaller
  20. since  it  does  not  include  some of the special features required in FTN
  21. operations.  This version should be used only on systems that do not have a
  22. mailer or where the mailer does not support XPR protocols.
  23.  
  24.     Fixes and Enhancements:
  25.  
  26.     o  REQUIRES wb2+
  27.  
  28.     o  Locale support.
  29.  
  30.     o  Defaults optimized for each library to permit MUCH shorter setup
  31.        strings.
  32.  
  33.     o  XPR 2.001 support for dual-status windows.  
  34.        Protocol now informs host that it supports XPR 2.001 extensions
  35.        and double-buffering.
  36.  
  37.     o  XPR 3 callbacks register protection is installed and the
  38.        xpr_updstatus function is enabled, permitting notification
  39.        of transfer status for EACH file sent or received.
  40.  
  41.     o  Protocol name displayed will be one of: 
  42.         Zmodem, 1K blocks standard
  43.         SZmodem, up to 8K blocks
  44.         ZedZap, up to 8K Blocks size based upon bps rate, ftn mode
  45.         ZedZip, 1k blocks, ftn mode
  46.         DirectZap, up to 8k blocks, minimum escaping, ftn mode
  47.  
  48.     o  Added status messages for resume
  49.  
  50.     o  A number of strings were not localized, corrected.  Also added
  51.        localization for new options.  These are NOT translated for
  52.        german catalog, so that catalog has been removed from distribution.
  53.        Catalogues   and   documentation   for  other  languages  should  be
  54.        distributed separately.
  55.  
  56.    o  During batch transfers, Error message field is set to "None" when
  57.       starting to send or receive next file.
  58.  
  59.    o  New options:
  60.  
  61.     Z   - FTN mode
  62.     The Z option enables FTN operation, when Y, the following is in effect:
  63.         - RxTimeOut is restored to 600ms
  64.         - transfers start with blocksize specified in M option.
  65.         - block size baud-rate dependant
  66.         - serialbuffer is cleared before sending/receiving.  In FTN
  67.           mode the turnaround from sending to receiving (and vis-versa)
  68.           is quite fast, clearing the buffer avoids reading echos of our
  69.           own characters or leftovers from the previous transfer.
  70.  
  71.     M<block size>
  72.         The  maximum  packet  size can now be set with a maximum/default at
  73.     8192.   This  will vary when sending and will be static when receiving.
  74.     When  sending  in  FTN  mode, the maximum packet size will be baud rate
  75.     dependant,  and  the  size  is calculated with the formula MAX_PACKET =
  76.     (BPS_RATE  *  8192 / 9600).  BPS_RATE will be the link rate if set with
  77.     the C option.  You can specify a limit for the maximum packet size with
  78.     the  M  option,  but it only influence the packet size if it is smaller
  79.     than  8K  or  if  one  is  receiving a file.  When not in FTN mode, the
  80.     blocks size is NOT dependant upon the bps rate.
  81.  
  82.     C<link bps>
  83.         All  Buffer  allocations,  and  cps calculations will be based upon
  84.     link  rate  if passed with C<baud> option, otherwise they will be based
  85.     upon  LOCKED  bps.   When  the link rat eis used, the DataRate field of
  86.     status display will show the true CPS of each block.
  87.  
  88.     N   - send no files mode (DirectZap,  ZedZip  and  ZedZap protocols)
  89.         It  is  permitted  to  have  a session without sending or receiving
  90.     files  if  N  option is Y.  This is required with some protocols in FTN
  91.     mode  so  as not to generate a spurious failure after a mailer session.
  92.     This also changes EOF mode from sending CAN's to just sending ZFIN.
  93.         
  94.     Q   - DirectZap mode
  95.         Only  ZDLE  adn  ZDLEE  will be escaped if Q option is Y.
  96.  
  97.  
  98.     ToDO:   Add  support  for  TrapZap if someone tells me what the diff is
  99. from DirectZap :).
  100.  
  101.     Robert Williamson
  102.         FidoNet#1:167/104.0
  103.         AmigaNet#40:600/104.0
  104.         robert@ecs.mtlnet.org 
  105.  
  106.